home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / gfx / show / ripley.readme < prev    next >
Text File  |  1999-03-02  |  9KB  |  267 lines
  1. Short:    Mpeg video player 68k/powerup, including source
  2. Author:   Frank Pagels, Timm S. Mueller
  3. Uploader: Frank Pagels (copper@informatik.uni-rostock.de)
  4. Version:  0.4
  5. Type:     gfx/show
  6. Requires: Kickstart 3.0 (v39), 68020
  7.  
  8.  
  9.   originally released at the 'Bockbier & Hackbraten'
  10.   neoscientific summer conference
  11.  
  12.  
  13. introduction
  14. ----------------------
  15.  
  16.   Ripley is a mpeg video player, featuring
  17.   
  18.   - PPC support
  19.   - PicassoIV PiP support
  20.   - freely scalable window
  21.   - runs on any screenmode, including OCS/ECS/AGA, HAM, chunky,
  22.     hi- and truecolor, runs on any public screen, can open
  23.     an own public screen
  24.   - asynchronous I/O (68k version only)
  25.   - the framerate is by default determined by the video,
  26.     and may be optionally set to an user-defined value
  27.   - the brightness can be adjusted
  28.   - supports saving of the whole animation's frames
  29.   - can save 'snapshots' of single frames while running
  30.  
  31.  
  32. todo
  33. ----------------------
  34.  
  35.   - faster replay
  36.   
  37.   - dithering on 8bit displays
  38.   
  39.   - slide forward/backward 
  40.   
  41.   - mpeg2 videos are not replayed correctly yet.
  42.  
  43.   - sound. we're considering an mpeg sound replay via
  44.     mpega.library.
  45.   
  46.   - HAM is fully supported in high quality,
  47.     but rendering is very slow.
  48.  
  49.  
  50.  
  51. usage
  52. ----------------------
  53.  
  54.   commandline arguments:
  55.  
  56.   FILE/A         - mpeg video file
  57.   GREY/S         - use greyscale
  58.   PIP/S          - use PicassoIV PiP window
  59.   SNAP/S         - snap window to the video's dimensions
  60.   LOOP/S         - loop
  61.   FPS/S          - display FPS counter
  62.   FRAMERATE/N    - set framerate [fps]
  63.   IGNOREFPS/S    - play at maximum speed
  64.   CUSTOMSCREEN/S - open an own (public) screen
  65.   SCRWIDTH/N     - screen width [pixels]
  66.   SCRHEIGHT/N    - screen height [rows]
  67.   DEPTH/N        - screen depth [1...24]
  68.   HAM/S          - open HAM screen (DEPTH required)
  69.   PUBSCREEN/K    - name of a pubscreen to open upon
  70.   BORDERLESS/S   - open a borderless window
  71.   WINSIZE        - window size mode;
  72.                    SMALL, HALF, LARGE, VISIBLE or FULL
  73.   SAVE/K         - filename template for saving, e.g. 
  74.                    pic%d or pic%d%c for fieldwise storage
  75.   SAVEFORMAT/K   - file-format for saving, PPM or YUV
  76.   TASKPRI/N      - task priority
  77.  
  78.  
  79.   Ripley can be controlled via keyboard.
  80.  
  81.   t      - toggle frames-per-second counter
  82.   g      - toggle grey/color mode
  83.   space  - freeze display
  84.   s      - snapshot the current frame in PPM format
  85.   +      - increase brightness
  86.   -      - decrease brightness
  87.   #      - reset brightness
  88.   0      - limit to the video's frame rate
  89.   1      - replay with 5 frames per second
  90.   2      - replay with 10 frames per second
  91.   3      - replay with 15 frames per second
  92.   4      - replay with 20 frames per second
  93.   5      - replay with 25 frames per second
  94.   6      - replay with 30 frames per second
  95.   7      - replay with 50 frames per second
  96.   8      - replay with 60 frames per second
  97.   9      - replay with maximum speed
  98.   
  99.   F1     - snap window to the animation's size
  100.   F2     - small window
  101.   F3     - half window
  102.   F4     - large window
  103.   F5     - visible window
  104.   F6     - full window
  105.  
  106.  
  107. requirements
  108. --------------------------------------
  109.  
  110.   - os3.0 (v39)
  111.   - 68020 or PPC (powerup)
  112.   - guigfx.library (dev/misc/GuiGFXLib.lha)
  113.   - render.library (dev/misc/RenderLib.lha)
  114.   - asyncio.library (dev/c/AsyncIO.lha. required in the 68k version only.)
  115.  
  116.   optional:
  117.  
  118.   - picasso96api.library
  119.   - cybergraphics.library
  120.  
  121.  
  122.  
  123. technical details
  124. ----------------------
  125.  
  126.  
  127. general:
  128.  
  129. - ripley is (hopefully) still in full compliance to ISO
  130. specifications. we tried to not sacrifice precision for
  131. speed.
  132.  
  133. - mpeg2 is currently not fully supported. we have
  134. restructured major parts in the display section, and we
  135. haven't found the time yet to integrate the second
  136. half-frame into the display logic.
  137.  
  138. - we have not seen ripley crashing from corrupt animations
  139. so far. ripley sometimes exits without closing the window
  140. when data is heavily corrupted, and we will try to fix this.
  141.  
  142.  
  143.  
  144. 68k version:
  145.  
  146. - all assembler optimizations intend to maximum performance
  147. on 68060 processors. some parts use arithmetics where tables
  148. would be faster on lower processors. ripley is yet fully
  149. compatible to all 68020++ systems with FPU.
  150.  
  151. - ripley uses a 18bit tabular colorpace conversion,
  152. providing almost the same performance as simple greyscale
  153. rendering. the output slightly suffers from limited
  154. precision, though. note: colorspace conversion table
  155. requires 1mb (!) of memory.
  156.  
  157.  
  158.  
  159. authors
  160. ----------------------
  161.  
  162.   Frank 'Copper' Pagels / Defect Softworks
  163.     (Initiator,PPC version, PiP features)
  164.     copper@informatik.uni-rostock.de
  165.  
  166.   Bifat / TEK neoscientists
  167.     (68k version)
  168.     timm.mueller@darmstadt.netsurf.de
  169.   
  170.   support site:
  171.     http://come.to/neoscientists
  172.  
  173.  
  174. history
  175. ----------------------
  176.  
  177.   0.4 - 68k version: some speed increase.
  178.         ripley now uses a pervert buffer size (1 mb)
  179.         for high-speed colorspace conversion.
  180.       - brightness correction is now implemented in
  181.         color mode.
  182.       - 68k version: removed visual artifacts resulting
  183.         from idct bugs.
  184.       - size of the load buffer slightly enlarged.
  185.       - the space key can be used to pause.
  186.       - CTRL_C has been implemented.
  187.       - snapshot implemented
  188.   
  189.   0.3 - added ppc version, screen handling, keyboard
  190.         shortcuts, saving, borderless window, HAM support
  191.   
  192.   0.2 - initial beta release at the
  193.         'bockbier & hackbraten'
  194.         neoscientific summer conference
  195.         
  196.  
  197.  
  198. ============================= Archive contents =============================
  199.  
  200. Original  Packed Ratio    Date     Time    Name
  201. -------- ------- ----- --------- --------  -------------
  202.   167300   70953 57.5% 21-Feb-99 11:03:38 +Ripley.elf
  203.    69468   37584 45.8% 21-Feb-99 23:11:50 +Ripley_68020
  204.    65708   35392 46.1% 21-Feb-99 23:16:02 +Ripley_68040
  205.    65704   35392 46.1% 21-Feb-99 23:23:42 +Ripley_68060
  206.     9636    2162 77.5% 02-Oct-98 19:30:14 +block.asm
  207.      205     104 49.2% 01-Oct-98 16:59:18 +block.h
  208.     8904    3111 65.0% 16-Jan-99 12:21:10 +commandline.c
  209.      771     352 54.3% 16-Jan-99 12:21:46 +commandline.h
  210.     1592     773 51.4% 01-Oct-98 16:59:18 +config.h
  211.       90      79 12.2% 01-Oct-98 16:59:18 +Devpac.opts
  212.     3877    1587 59.0% 21-Feb-99 10:58:46 +display.c
  213.     9104    1813 80.0% 03-Oct-98 22:54:28 +fcprediction.asm
  214.      110      89 19.0% 02-Oct-98 19:30:24 +fcprediction.h
  215.     4678    1767 62.2% 17-Jan-99 00:39:24 +getbits.c
  216.    12737    2585 79.7% 01-Oct-98 16:59:18 +getblk.c
  217.    29538    6652 77.4% 01-Oct-98 16:59:18 +gethdr.c
  218.    34500    9298 73.0% 04-Oct-98 17:41:12 +getpic.c
  219.    15578    3126 79.9% 01-Oct-98 16:59:18 +getvlc.c
  220.    20126    3315 83.5% 01-Oct-98 16:59:18 +getvlc.h
  221.    14379    4543 68.4% 16-Jan-99 16:44:24 +global.h
  222.    11892    3647 69.3% 02-Oct-98 19:30:54 +idct.asm
  223.     5757    2080 63.8% 01-Oct-98 16:59:20 +idct.c
  224.     9346    2105 77.4% 04-Oct-98 23:32:16 +idctppc.asm
  225.     2890    1370 52.5% 01-Oct-98 16:59:20 +idctref.c
  226.    14790    1760 88.1% 23-Jan-99 14:45:54 +cybergraphics_pragmas.h
  227.    19593    2131 89.1% 23-Jan-99 14:45:52 +guigfx_pragmas.h
  228.    17052    1972 88.4% 23-Jan-99 14:45:54 +Picasso96_pragmas.h
  229.      454     240 47.1% 23-Jan-99 14:45:52 +cybergraphics.h
  230.      417     228 45.3% 23-Jan-99 14:45:52 +guigfx.h
  231.      444     232 47.7% 23-Jan-99 14:45:50 +Picasso96.h
  232.     7026    2147 69.4% 01-Oct-98 16:59:20 +motion.c
  233.    23021    6794 70.4% 20-Feb-99 11:41:08 +mpeg2dec.c
  234.     4087    1478 63.8% 01-Oct-98 18:18:28 +mpeg2dec.h
  235.    28904    7186 75.1% 19-Feb-99 17:06:48 +mplay.c
  236.     2499     963 61.4% 19-Feb-99 14:31:30 +mplay.h
  237.    22960    4625 79.8% 03-Oct-98 22:32:06 +recon.c
  238.    10832    2761 74.5% 17-Nov-98 03:29:52 +screen.c
  239.     1143     358 68.6% 01-Oct-98 16:59:20 +screen.h
  240.     1928     739 61.6% 21-Feb-99 23:05:16 +smakefile-68020-release
  241.     1929     740 61.6% 21-Feb-99 23:05:22 +smakefile-68040-release
  242.     1929     742 61.5% 21-Feb-99 23:05:28 +smakefile-68060-release
  243.     1870     716 61.7% 21-Feb-99 14:16:06 +smakefile-68k
  244.     1765     669 62.0% 21-Feb-99 14:17:02 +smakefile-68k-conly
  245.     1774     672 62.1% 21-Feb-99 14:17:18 +smakefile-68k-conly-opt
  246.     1872     715 61.8% 21-Feb-99 14:15:54 +smakefile-68k-opt
  247.     1811     660 63.5% 21-Feb-99 14:17:50 +smakefile-ppc
  248.     1767     642 63.6% 29-Sep-98 18:03:52 +smakefile-ppc-opt
  249.     1806     661 63.3% 18-Oct-98 21:06:48 +smakefile-ppc-release
  250.      701     186 73.4% 21-Feb-99 14:21:54 +smakefiles.README
  251.     9562    2446 74.4% 01-Oct-98 16:59:20 +spatscal.c
  252.    15050    3739 75.1% 01-Oct-98 16:59:20 +store.c
  253.    10635    3476 67.3% 01-Oct-98 16:59:20 +subspic.c
  254.     4616    1762 61.8% 02-Oct-98 19:31:06 +systems.c
  255.     2157     704 67.3% 01-Oct-98 16:59:20 +timer.asm
  256.       90      74 17.7% 01-Oct-98 16:59:20 +timer.h
  257.      256     150 41.4% 29-Sep-98 17:17:30 +timerppc.asm
  258.     8639    2726 68.4% 01-Oct-98 16:59:22 +verify.c
  259.    13679    3322 75.7% 02-Oct-98 19:31:06 +yuvconversion.asm
  260.     2652     857 67.6% 01-Oct-98 18:18:54 +yuvconversion.c
  261.     1156     264 77.1% 01-Oct-98 18:18:56 +yuvconversion.h
  262.     4212    1016 75.8% 29-Sep-98 17:15:04 +yuvconversionppc.asm
  263.    18080   10178 43.7% 18-Aug-98 23:31:34 +summerconference.iff
  264.     5473    2423 55.7% 23-Feb-99 12:38:58 +ripley.readme
  265. -------- ------- ----- --------- --------
  266.   832521  303033 63.6% 24-Feb-99 22:43:44   63 files
  267.